home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / game / misc / AGPLapTime.lha / AGPLapTime.doc < prev    next >
Text File  |  1996-12-21  |  27KB  |  701 lines
  1.  
  2.                              AGPLapTime 1.1
  3.  
  4.                                    by
  5.  
  6.                                 Rene Smit
  7.  
  8.                               December 1996
  9.  
  10.  
  11.  
  12. This document describes AGPLapTime, a utility with which you can log your
  13. races in World Circuit/Formula One Grandprix. This utility is freeware.
  14.  
  15. If you want to complain, ask questions or exchange deeper thoughts about
  16. AGPLapTime, SplitTime or F1GP feel free to contact me:
  17.  
  18. E-Mail:
  19.  
  20.         rsdi@xs4all.nl
  21.  
  22. WWW:
  23.         http://www.xs4all.nl/~rsdi/
  24.  
  25.  
  26.  
  27. Contents:
  28. ----------------------------------------------------------
  29. 1. DISCLAIMER
  30. 2. DISTRIBUTION
  31. 3. WHAT IS REQUIRED?
  32. 4. WHAT IS AGPLAPTIME?
  33.   4.1. Usage
  34.     4.1.1. -c option
  35.     4.1.2. -b option
  36.     4.1.3. [<logfile>]
  37.     4.1.4. -w option
  38.     4.1.5. Examples
  39. 5. HOW DO I ANALYZE THE LOGFILE?
  40.   5.1. AGPLap
  41.     5.1.1. [<logfile>]
  42.     5.1.2. -w option
  43.     5.1.3. -t option
  44.     5.1.4. -/+[H/C]slfpr ... options
  45.       5.1.4.1. examples
  46.     5.1.5. Example output
  47.     5.1.6. Log entries
  48.       5.1.6.1. lap time, setup and fastest lap entries
  49.       5.1.6.2. pitstop entries
  50.       5.1.6.3. retirement entry
  51.     5.1.7. Tyre grip
  52.     5.1.8. Statistics table
  53.       5.1.8.1. table contents
  54.       5.1.8.2. example
  55.   5.2. AGPLapD
  56.     5.2.1. Usage
  57.     5.2.2. The interface
  58.       5.2.2.1. the AGPLapD window
  59.       5.2.2.2. the Info window
  60.   5.3. AGPLapMix
  61.     5.3.1. Usage
  62.     5.3.2. Examples
  63. 6. THANK LIST
  64.  
  65.  
  66.  
  67.  
  68. 1. DISCLAIMER
  69. =============
  70.  
  71. I hereby state that I am not responsible for any damage or loss of
  72. data, whether or not caused by using either AGPLapTime or AGPLap.
  73. If it crashes in the middle of an important race then that's not my
  74. responsibility. Please make sure it works properly on your system first.
  75. If you have any problems, try to run F1GP without AGPLapTime. If you're
  76. sure AGPLapTime causes problems for you please (e)mail me personally,
  77. and I'll try to solve them.
  78.  
  79.  
  80.  
  81.  
  82. 2. DISTRIBUTION
  83. ===============
  84.  
  85. You may copy AGPLapTime to everyone as long as you copy the original
  86. lha file containing the following files:
  87.  
  88. - AGPLapTime            F1GP logger        (c) 1995/96 Rene Smit
  89. - AGPLapTime.doc    Documentation file
  90. - AGPLapTime.doc.info
  91. - AGPLap                Logfile analyzer    (c) 1995/96 Rene Smit
  92. - AGPLapD        Logfile viewer        (c) 1995/96 Grant Reeve
  93. - AGPLapMix             Logfile mixer        (c) 1995    Grant Reeve
  94. - libs/f1gp.library     F1GP library        (c) 1995/96 Oliver Roberts
  95.  
  96. The f1gp.library was made by Oliver Roberts. The version of the library
  97. included here is 35.1.
  98.  
  99. AGPLapD and AGPLapMix were made by Grant Reeve.
  100.  
  101.  
  102.  
  103.  
  104. 3. WHAT IS REQUIRED?
  105. ====================
  106.  
  107. - Any Amiga.
  108. - F1GP from Microprose, any version (European F1GP, World Circuit or the
  109.   A600 WWW version).
  110. - Oliver Roberts' f1gp.library, necessary for AGPLapTime to work.
  111.   f1gp.library is included with AGPLapTime in the directory 'libs'. You need
  112.   to copy the library to your libs: directory. If you already have one from
  113.   the latest f1gp-ed, you don't need to do that as the f1gp.library supplied
  114.   with f1gp-ed is always the same or newer as the one included here.
  115.  
  116.  
  117.  
  118.  
  119. 4. WHAT IS AGPLAPTIME?
  120. ======================
  121.  
  122. AGPLapTime is a utility that logs interesting information while you're
  123. playing F1GP. Here is a quick list of most of the things that are logged:
  124.  
  125. - Lap times:    Every time a car passes the start/finish line, the laptime and
  126.                 cumulative race time is logged, as well as the tyre grip. See
  127.                 section 5.1.6.1.
  128. - Fastest laps: If the laptime improves the fastest lap of the session, the
  129.                 horsepower, opposition level, speed factor, frame rate and
  130.                 race distance (if it's a race) is logged. See section 5.1.6.1.
  131. - Setup:        Front/rear wing, brake balance, gear ratio's, tyre compound,
  132.                 traction control on/off is logged. See section 5.1.6.1.
  133. - Pitstops:     At each pitstop the damage and pitstop duration is logged.
  134.                 When leaving the pits, the tyre compound is logged. See
  135.                 section 5.1.6.2.
  136. - Retirements:  If a car is involved in a fatal crash this is logged right
  137.                 away, as well as the yellow flag and car removal delays, and
  138.                 the position of the car. See section 5.1.6.3.
  139.  
  140.  
  141. Besides the player's car, computer cars can be logged too, although they are
  142. not very interesting (unless you want to analyse their strategies while
  143. changing several settings in F1GP-Ed, for example).
  144. If only 1 player is being logged, the logfile will grow the size of about 4Kb
  145. for a full-length race. With 25 computer cars as well, it will get about
  146. 100Kb, but usually it's smaller.
  147.  
  148.  
  149.  
  150. 4.1 Usage
  151. =========
  152.  
  153. AGPLapTime should be started from cli/shell with the following synopsis:
  154.  
  155.   AGPLapTime [-w] [-c] [-b <bufsize>] [<logfile>]
  156.  
  157. The options _cannot_ be concatenated (e.g. -wc).
  158.  
  159.  
  160. 4.1.1. -c option
  161. ----------------
  162. By default, computer cars are not being logged. To turn this on, specify
  163. the '-c' option. Note that in multiplayer games a player's car controlled
  164. by the computer is not a computer car.
  165.  
  166.  
  167. 4.1.2. -b option
  168. ----------------
  169. The '-b' option specifies how large the buffer for the logfile is. Because I
  170. can't write logged data to disk while you're in the cockpit I use a buffer.
  171. This buffer can be flushed to disk during F1GP menu interaction if you
  172. give it the flush command: ctrl-f. The buffer is flushed too if you quit
  173. AGPLapTime, either by giving the ctrl-c command, or by quitting F1GP.
  174. These commands can be given by pressing the corresponding key combination
  175. in the cli AGPLapTime is started from, or with a special program like 'break'
  176. in your c: directory (after finding out it's process number with 'status').
  177.  
  178. The default buffer size is about 10Kb. If the '-c' option is specified this
  179. default size is about 128Kb. People that are low on memory may have to
  180. specify a smaller buffer size with the '-b' option. The given size must be
  181. in kilobytes.
  182.  
  183. If the buffer overflows, there are no records logged anymore until the
  184. buffer is flushed. There will appear a message telling you that some records
  185. are lost if this happens, so make sure your buffer is big enough!
  186. After flushing the buffer it will always be empty again, unless an error
  187. occurred while trying to write to the file.
  188.  
  189.  
  190. 4.1.3. [<logfile>]
  191. ------------------
  192. The default filename for the logfile is "agplap.log". You can specify a
  193. different name by just typing it on the command line (it may not start with
  194. a '-', or it will be interpreted as an option).
  195.  
  196.  
  197. 4.1.4. -w option
  198. ----------------
  199. The '-w' option will enable automatic writing. Once you get out of the
  200. cockpit or you're in accelerated time, and this option is specified,
  201. AGPLapTime will write out (flush) the buffer to the logfile right away.
  202. For this option to work, you need at least v37 of the OS.
  203. There won't appear a message that the buffer is saved, unless there was
  204. an error. Also, an empty buffer will be saved right away when AGPLapTime
  205. is started, to be able to start AGPLap with option '-w' righ after that.
  206.  
  207.  
  208. 4.1.5. Examples
  209. ---------------
  210.  
  211.   AGPLaptime phoenix.log
  212.  
  213. will log only players' cars, with a 10Kb buffer which will be flushed to
  214. the file "phoenix.log" upon exit, or upon receiving the flush command.
  215.  
  216.   AGPLaptime -w -c -b100 imola_cc.log
  217.  
  218. will log all cars, with a 100Kb buffer which will be flushed to the file
  219. "imola_cc.log" automatically.
  220.  
  221.  
  222.  
  223.  
  224. 5. HOW DO I ANALYZE THE LOGFILE?
  225. ================================
  226.  
  227. There are two tools to analyze the logfile: AGPLap and AGPLapD.
  228.  
  229.  
  230.  
  231. 5.1. AGPLap
  232. ===========
  233.  
  234. A seperate tool called AGPLap can be used to output the logfile in ASCII
  235. format. Call it from cli/shell with the following synopsis:
  236.  
  237. Usage: AGPLap [-w] [-t] [-/+[H/C]slfpr] ... [<logfile>]
  238.  
  239. Everything between [] brackets is optional. All options are case insensitive.
  240. It may look a bit complex at first sight, but it isn't :). The options
  241. consist of three optional parts:
  242.  
  243.  
  244. 5.1.1. [<logfile>]
  245. ------------------
  246. The default name for the logfile is "agplap.log". You can specify a different
  247. name on the commandline as long as it doesn't start with a '-' or a '+'.
  248.  
  249.  
  250. 5.1.2. -w option
  251. ----------------
  252. The '-w' option will enable logfile notification and makes AGPLap wait
  253. forever after printing all log entries until ctrl-c is pressed. Whenever
  254. there are new entries written to the file, AGPLap will print them right away.
  255. This way you don't need to print the complete logfile every time you take a
  256. look during a race.
  257. This option can best be used in conjunction with the '-w' command of
  258. AGPLapTime: if you go into accelerated time you will see computer cars being
  259. logged (if enabled) straight away. Don't ask me of how much use this is, but
  260. I use this to test stuff.
  261.  
  262.  
  263. 5.1.3. -t option
  264. ----------------
  265. This option will suppress the output of the statistics table. This table
  266. is explained in section 5.1.8. (Statistics table).
  267.  
  268.  
  269. 5.1.4. -/+[H/C]slfpr ... options
  270. --------------------------------
  271. This is the part that lets you select which entries you would like to see.
  272. Also, the '...' means you can specify it as many times as you like.
  273. It starts with either a '-' or a '+', then is optionally followed by a 'H'
  274. or a 'C', then followed by 0 or more of the characters 'slfpr'.
  275.  
  276. By default, all log entries are printed. A '-' option will then skip a
  277. certain type of entry. The options and entries are mapped as follows:
  278.  
  279. Option  Entry Type
  280.   s     setups
  281.   l     laptimes
  282.   f     fastest laps
  283.   p     pitstops
  284.   r     retirements
  285.  
  286. Also, an 'H' or 'C' can further specify entries. If the 'H' is specified,
  287. then the following options only affect human player cars. If the 'C is
  288. specified, then the following options only affect computer cars. If neither
  289. 'H' or 'C' is specified, then the following options will affect all cars.
  290.  
  291. If there appears a '+' option however, all entries will _not_ be printed,
  292. except all the specified ones, including the '-' options. So the '+' is
  293. dominant: once for a certain type of car (human or computer) a '+' option
  294. is specified, the '-' options will turn into '+' options for that type of
  295. car.
  296.  
  297. 5.1.4.1. examples
  298. -----------------
  299. +C              print human player entries only.
  300. -Hfs +Cpr       print all human players entries except fastest laps and
  301.                 setups, and also all computer pitstops and retirements.
  302. +lp             print all laptime and pitstop entries.
  303. +p -Cf          print all computer fastest laps, and pitstops of all cars.
  304. +               print no entries.
  305.  
  306.  
  307. 5.1.5. Example output
  308. ---------------------
  309.  
  310. Track 1: Phoenix, Race
  311. Car Driver                 Lap CP TG LapTime  BestTime  SessionTime Difference
  312. ------------------------------------------------------------------------------
  313. Setup [64/48]  14R  [26,32,39,45,51,57]  TC on; C-compound
  314. %39 Rene Smit                0 24 86 -:--.--- -:--.---  0h00m09.339 + 0:07.588
  315. Setup [64/46]  12R  [27,33,39,45,51,57]  TC on; C-compound
  316. *38 Grant Reeve              0 26 86 -:--.--- -:--.---  0h00m10.343 + 0:08.592
  317. %38 Grant Reeve              1 12 88 1:32.123 1:32.123= 0h01m42.466 + 0:12.914
  318. *39 Rene Smit                1 21 88 1:46.394 1:46.394= 0h01m55.733 + 0:26.181
  319. *38 Grant Reeve              2 12 90 1:32.231 1:32.123  0h03m14.697 + 0:20.418
  320. %39 Rene Smit                2 22 90 Pits in  FW        0h03m48.073
  321. %39 Rene Smit                2 24 -- Pits out on C's    0h04m08.837 pit 20.764
  322. %38 Grant Reeve              3  8 92 1:26.362 1:26.362= 0h04m41.059 + 0:16.884
  323. *39 Rene Smit                3 24 88 -:--.--- 1:46.394  0h05m42.135 + 1:17.960
  324. *39 Rene Smit                4 24 -- Retired   61;  8%  0h05m50.992 0:03, 0:30
  325. %38 Grant Reeve              4  8 92 1:30.496 1:26.362  0h06m11.555 + 0:22.813
  326. *38 Grant Reeve              5  8 92 1:31.839 1:26.362  0h07m43.394 + 0:27.930
  327. *38 Grant Reeve              6  8 92 1:21.849 1:21.849! 0h09m05.243 + 0:26.661
  328. FL 1:21.849 Grant Reeve, Ace, 716 HP, SF 16384, FR 10.0, 100%
  329. *38 Grant Reeve              7 -- -- Retired  268; 35%  0h09m40.286 0:03, 0:30
  330.  
  331.  
  332. This logfile was made during a multiplayer game, and the computer cars were
  333. logged too, but have been filtered out here by using the '+C' option.
  334.  
  335. The top line tells you what each column means. This column layout refers to
  336. laptime entries but certain columns are related to some other entries too.
  337. This is what each column means:
  338.  
  339.   - Car         The car number.
  340.                 It is preceded by one of the following characters:
  341.                   . '*' if a player is in control of the car.
  342.                   . '%' if the computer has control of this player's car
  343.                         in multiplayer mode.
  344.                   . '#' if this is a computer car.
  345.  
  346.   - Driver      Driver name.
  347.   - Lap         Lap number. Races begin with lap 0 at the start.
  348.                 Other sessions start with lap number 1.
  349.   - CP          Car position. In non-race sessions this is the ranking in
  350.                 the fastest lap table.
  351.   - TG          Tyre grip. This is explained in section 5.1.7. (Tyre grip).
  352.   - LapTime     Lap time. Is '-:--.---' on first lap out of the pit.
  353.   - BestTime    Best personal time in the session.
  354.   - SessionTime Session time. In the race, this is the exact race time which
  355.                 starts at the green light.
  356.   - Difference  Race only, this is the time difference between this car and
  357.                 the leader.
  358.  
  359.  
  360. 5.1.6. Log entries
  361. ------------------
  362. I will now explain each log entry type in detail with use of the example.
  363.  
  364. 5.1.6.1. lap time, setup and fastest lap entries
  365. ------------------------------------------------
  366. Everytime a car crosses the start/finish line a laptime entry is logged.
  367. If this is the first one in a session, a setup entry is logged as well.
  368. The following is printed in this case:
  369.  
  370. Track 1: Phoenix, Race
  371. Setup [64/48]  14R  [26,32,39,45,51,57]  TC on; C-compound
  372. %39 Rene Smit                0 24 86 -:--.--- -:--.---  0h00m09.339 + 0:07.588
  373.  
  374. It first prints the track name and session mode. The session mode is one of
  375. the following:
  376.  
  377.   - Practise Circuit
  378.   - Free Practice
  379.   - Qualifying
  380.   - Pre-Race Practice
  381.   - Race
  382.  
  383. The string ' (wet)' is added if it's a wet session (only for pre-race practise
  384. and race). 'Practise Circuit' stands for the 'Practise any circuit' option in
  385. the main menu. The race is either a quick race, a non-championship race or a
  386. championship race.
  387. It then prints the setup: front and rear wing, front or rear brake bias, gear
  388. ratio's, traction control (TC) on or off, and finally the used tyre compound.
  389. This tyre compound isn't always the same as selected in the garage, e.g. in
  390. non-race sessions this compound will be the one you selected from within the
  391. car. So, it's always the compound you're driving on at that moment.
  392.  
  393. A normal laptime entry will look like this:
  394.  
  395. %38 Grant Reeve              4  8 92 1:30.496 1:26.362  0h06m11.555 + 0:22.813
  396.  
  397. Here, a car just finishes lap 4 in position 8. The laptime is 1:30.496 and his
  398. personal best time is 1:26.362.
  399.  
  400. In case the car sets a best session time, a fastest_lap entry is logged:
  401.  
  402. *38 Grant Reeve              6  8 92 1:21.849 1:21.849! 0h09m05.243 + 0:26.661
  403. FL 1:21.849 Grant Reeve, Ace, 716 HP, SF 16384, FR 10.0, 100%
  404.  
  405. After the best laptime a '!' is added so fastest laps can be recognized if
  406. printing of fastest_laps entries is skipped. This will be reset for each
  407. session. If the laptime is an improvement of the personal best laptime,
  408. a '=' is added.
  409.  
  410. The fastest_lap entry starts with 'FL', followed by the time, the driver name,
  411. the opposition level, horsepower value, speed factor SF, frame rate FR, and
  412. finally a short session name (Prac, FrPr, Qual or PRPr) for non-race sessions,
  413. and the race distance in percentage for race sessions. If you happen to drive
  414. a fastest lap, and drive exactly the same laptime in another lap, a
  415. fastest_lap entry will be logged again.
  416.  
  417. The speed factor (SF) is some sort of grip value for this particular car. For
  418. a player's car this value will almost always be equal to 16384. For computer
  419. cars it will be that too, unless you're using F1GP-Ed and you've specified a
  420. different speed factor, or you've installed the Local Speed Factor patch.
  421. In that case the SF value will be near or equal to F1GP-Ed's SF value, where
  422. slower computer cars will have a slightly lower speed factor.
  423.  
  424. 5.1.6.2. pitstop entries
  425. ------------------------
  426. Pitstops consist of a pair of entries. When a car comes in for a pitstop, a
  427. pits_in entry is logged (when the car is put onto the jacks):
  428.  
  429. %39 Rene Smit                2 22 90 Pits in  FW        0h03m48.073
  430.  
  431. If the car has damage, any broken wings are logged. 'FW' means the front
  432. wing, and 'RW' means the rear wing is broken.
  433.  
  434. When the car comes off the jacks, a pits_out entry is logged:
  435.  
  436. %39 Rene Smit                2 24 -- Pits out on C's    0h04m08.837 pit 20.764
  437.  
  438. The tyre compound is printed which was chosen from within the car during the
  439. pitstop, C-compound in this case. In the 'Difference' column the duration of
  440. the pitstop is printed, preceded by the word 'pit'.
  441.  
  442. 5.1.6.3. retirement entry
  443. -------------------------
  444. If a car has a fatal crash, a retirement entry is logged, right at the moment
  445. of the impact:
  446.  
  447. *38 Grant Reeve              7 -- -- Retired  268; 35%  0h09m40.286 0:03, 0:30
  448.  
  449. The number after 'Retired' is the segment number where you crashed. You can
  450. use this number to locate the track position with the perf file viewer
  451. GPDisplay. The percentage shows where you crashed compared to the total lap,
  452. e.g. if you crashed halfway a lap it says 50%.
  453.  
  454. In the 'Difference' column are two times printed: the first one is the yellow
  455. flag delay, and the second one is the car removal delay. This should be an
  456. indication of how long it takes before the road is clear again.
  457.  
  458. Note that if the car is involved in another fatal crash right after the first
  459. one, another entry is logged. If two cars fatally crash against each other,
  460. their entries contain the same session time.
  461.  
  462. Normal crashes are not logged, but if there is a crash, the damage can be seen
  463. in the pits_in entry if the car drives into the pits.
  464.  
  465.  
  466. 5.1.7. Tyre grip
  467. ----------------
  468. With each laptime entry and pits_in entry the tyre grip is logged. This
  469. value indicates the condition of your tyres, and it changes while you're
  470. driving. The grip has an initial ('cold') value which depends on the tyre
  471. compound, the track and the weather conditions (wet or dry).
  472. Here is a list of all cold values for all compounds:
  473.  
  474.  
  475.                               Dry conditions       Wet conditions
  476. Tracks                  A   B   C   D   Q(warm) W      Slicks  W
  477. -----------------------------------------------------------------
  478. 2,4,7,10,12,13,14,15    82  85  88  89  83(99)  78     01      57
  479. 3,1,6,8,9,11,16         81  84  86  88  82(98)  77     00      56
  480. 5                       80  83  85  87  80(96)  75     00      55
  481.  
  482.  
  483. I have added the 'warm' values for Q-compound tyres too, which gives the
  484. highest possible grip for that track. The optimum values for the other
  485. compounds can be extracted from the logfiles: while warming up the tyres
  486. the value will increase until they reach optimum grip. It will stay constant
  487. for a certain number of laps (this will influence your pit strategy) and
  488. drops at the moment the tyres are wearing out. It will then take a certain
  489. number of laps (depending on the track and compound) before the value drops
  490. below the cold value.
  491. From the example above you can see that in Phoenix the optimum grip for
  492. C's is 92. For all other race-compounds on all tracks the warm value is about
  493. 6 higher than the cold value too.
  494. In wet races the tyres don't warm up, so the grip value will then stay
  495. constant.
  496.  
  497. These grip values are not the original values that the game uses. I have
  498. scaled them to be between 0 and 99, taking slicks in the wet as a minimum
  499. and the highest possible Q value as a maximum. I did this to keep the output
  500. small and to make it more intuitive to read.
  501.  
  502.  
  503. 5.1.8. Statistics table
  504. -----------------------
  505. This table is printed at the end of each session, and shows statistics
  506. about the session. It's most interesting for a race and if there is more
  507. than one driver. There are statistics in several columns for each driver.
  508.  
  509. 5.1.8.1. table contents
  510. -----------------------
  511. This is what each column means:
  512.  
  513. Finishing position
  514. |  Car number
  515. |  |    Total race time
  516. |  |    |          Fastest lap
  517. |  |    |          |        Lap in which fastest lap was done
  518. |  |    |          |        |  #Laps led
  519. |  |    |          |        |  |  #Laps done
  520. |  |    |          |        |  |  |  #Pitstops
  521. |  |    |          |        |  |  |  |  Average pitstop loss
  522. |  |    |          |        |  |  |  |  |        Average tyre grip
  523. |  |    |          |        |  |  |  |  |        |   #Laps done per compound
  524. |  |    |          |        |  |  |  |  |        |   |  |  |  |  |  |
  525. FP Car  Race_Time  Fast_Lap FL LL/TL PS Avg_Pits AG  A  B  C  D  Q  W
  526.  
  527. Average pitstop loss shows the relative amount of time that is wasted
  528. with a pitstop. It's the difference between two normal laps and the two
  529. laps involved with the pitstop, including standing still.
  530.  
  531. The cars are sorted on laps done, then on race time.
  532.  
  533. 5.1.8.2. example
  534. ----------------
  535. Here is an example of statistics for a race:
  536.  
  537. FP Car  Race_Time  Fast_Lap FL LL/TL PS Avg_Pits AG  A  B  C  D  Q  W
  538. -----------------------------------------------------------------------
  539.  1.  6 1h42m06.850 1:13.893 65 52/78  2 0:29.308 93       57 21
  540.  2.  1 1h42m32.094 1:14.361 77 27/78  1 0:23.688 93       78
  541.  3.  9 1h43m14.608 1:14.911 57  0/78  1 0:19.058 93       45 33
  542.  4. 25 1h44m47.039 1:14.057 70  0/78  4 0:39.463 94       23 55
  543.  5. 22 1h45m22.844 1:15.889 76  0/78  1 0:18.916 93       78
  544.  6.  2 1h45m47.383 1:15.043 78  0/78  3 0:42.236 92    29 40  9
  545.  7. 38 0h42m49.197 1:19.318 24  0/27  5 0:44.181 93        6 21
  546.  
  547.  
  548.  
  549. 5.2. AGPLapD
  550. ============
  551.  
  552. Another way to analyze the logfiles is to use AGPLapD, a graphical logfile
  553. viewer. It's not a graphical substitute for AGPLap, since it doesn't show
  554. race times or lap times, but only time differences for each lap. This
  555. implies that it's only interesting if you log computer cars too, but there
  556. is another tool called AGPLapMix which can combine several logfiles into
  557. one (see section 5.3. AGPLapMix).
  558.  
  559. AGPLapD will not work with non-race sessions, so make sure your logfile
  560. only contains one race (AGPLapMix helps you with this).
  561.  
  562. Besides the time differences, AGPLapD also shows pitstops, retirements and
  563. a driver list.
  564.  
  565. AGPLapD was made by Grant Reeve.
  566.  
  567.  
  568. 5.2.1. Usage
  569. ------------
  570. You start AGPLapD from cli/shell with the following synopsis:
  571.  
  572. AGPLapD [logfile]
  573.  
  574. You can also load the log file from within the program.
  575.  
  576.  
  577. 5.2.2. The interface
  578. --------------------
  579. After you start the program, there will appear two windows, the AGPLapD
  580. window which contains the graph, and the Info window which contains the
  581. list of drivers. You can activate either window from the Windows menu.
  582.  
  583. There are two other menus: File and Prefs. From the File menu you can
  584. load a new log file, clear the current logfile, or quit.
  585. From the Prefs menu you can change screenmode,  colours and fonts, and
  586. you can save and load the preferences in several ways.
  587.  
  588. 5.2.2.1. the AGPLapD window
  589. ---------------------------
  590. This window shows a grid, with the lap number on the x-axis, and the
  591. time difference to the leader on the y-axis. So the leader's trace is
  592. always at the bottom of the graph, right on the x-axis (except for
  593. pitstops). Traces of the other drivers are drawn according to their
  594. gap to the leader.
  595.  
  596. A pitstop is drawn as a bold vertical bar, as the driver stands still
  597. in the pit. The height of that bar is exactly the amount of time the
  598. driver was on the jacks in the pit (usually about 8 seconds for a regular
  599. pitstop and about 0 seconds if one or two wings needed to be repaired).
  600.  
  601. A retirement is drawn as a little box at the end of the trace.
  602.  
  603. A black trace going from left to right indicates the leader, who is
  604. then lapping other cars. If it initiates from another driver's trace,
  605. or if it crosses one, it means that that driver is being passed by the
  606. leader. If it's the lowest black trace, he's lapped once, the next one
  607. means lapped twice, etc.
  608.  
  609. 5.2.2.2. the Info window
  610. ------------------------
  611. All drivers have unique colours (as long as they are available), and are
  612. sorted on their race position. They are listed in this window with the
  613. same colour as they are drawn with in the AGPLapD window. In that window
  614. you can see a cursor (a vertical line) that's on lap 0 after loading. In
  615. the Info window's title bar you can see that lap number, and the number of
  616. cars. You can move the cursor with the cursor keys; with shift there will
  617. be 10 laps skipped at once.
  618.  
  619.  
  620.  
  621. 5.3. AGPLapMix
  622. ==============
  623.  
  624. With this tool you can combine upto 64 log files together into one big log
  625. file. Thereby it can filter out any unwanted sessions. Actually, the most
  626. interesting use of this tool is to mix several races, which you can then
  627. view with AGPLapD or AGPLap.
  628.  
  629. You can mix log files from different tracks together. This is, of course,
  630. pointless.
  631.  
  632.  
  633. AGPLapMix was made by Grant Reeve.
  634.  
  635.  
  636. 5.3.1. Usage
  637. ------------
  638. AGPLapMix <mode> <inlogfile> [car#[/new#] [car#[/new#] [-aText]]...
  639.           [inlogfile] [car#[/new#] [-aText]].... <outlogfile>
  640.  
  641.   mode=A[BB...BB]
  642.     A is:    m=mix
  643.              a=append
  644.     B's are: f=strip free practice
  645.              q=strip qualifying
  646.              e=strip pre-race
  647.              r=strip race
  648.              p=strip practice
  649.  
  650. Mixing the logfiles is the most interesting (make sure they are from
  651. the same circuit). Appending will just concatenate the logfiles.
  652.  
  653. Behind each logfile you can specify any number of car numbers that
  654. you want to include. Each car number can be renumbered by adding a
  655. '/' with the number to the old number. This is necessary if the logfiles
  656. contain double car numbers, because double numbers will mess up pitstop
  657. times with AGPLap. AGPLapMix supports car numbers from 0 to 63.
  658.  
  659. Besides this renumbering you can additionally append some text to the
  660. driver name with the '-a' option followed by text. The total length of
  661. the name cannot be more than 23 characters. If the name will be too long
  662. it will be cut off.
  663.  
  664. Finally, specify the name of the output logfile.
  665.  
  666.  
  667. 5.3.2. Examples
  668. ---------------
  669.  
  670. * You have a log file containing a qualifying session and a race at
  671.   USA, and you want to filter out everything except what you and your
  672.   teammate did in the race. You are in car 39, he is in car 38:
  673.  
  674.   AGPLapMix mq usa.log 38 39 output.log
  675.  
  676. * You have two log files, of races at Imola, where you are in car 39
  677.   and you are called "Grant Reeve" :). You want to combine the two files
  678.   together so you can compare how the two different versions of you went:
  679.  
  680.   AGPLapMix m imola1.log 39/1 -aA imola2.log 39/2 -aB output.log
  681.  
  682.   imola1.log will become "Grant Reeve A" in car 1, and imola2.log
  683.   will become "Grant Reeve B" in car 2.
  684.  
  685.  
  686.  
  687.  
  688. 6. THANK LIST
  689. =============
  690.  
  691. I would like to thank Grant Reeve for encouraging me and for making
  692. AGPLapD and AGPLapMix.
  693.  
  694. Thanks to Oliver Roberts for beta-testing, and to other people
  695. that have reported bugs.
  696.  
  697. Thanks to Robert Schaftlein for sending me a cheque!
  698.  
  699. Finally, thanks to Trevor Kellaway, who has made GPLap for the PC, which
  700. inspired me to make a logger for the Amiga too.
  701.